JavaServer

Servlet Aliases


Documentation / Administrator Docs / Developer Docs / Index / Administration Contents

This document has the following sections:

The Servlet Aliases page allows you to specify the pathname mapping rules that the JavaServer uses to invoke servlets. These rules allow you to use a shortcut URL to call a servlet from your browser, or to embed the shortcut into your files. JavaServer servlets can be called from within HTML documents (using server-side includes) or from within other java programs.

For more information on servlets, see Introduction to Servlets, Internal Servlets, and JavaServer Architecture Overview.

Note: In most cases, servlets can be created and removed as needed. However, it is not a good idea to remove the following JavaServer system servlets: file, ssinclude, cgi, imagemap, and invoker.

Settings

The Servlet Alias page has the following fields:

Alias
The relative pathname for the servlet. Pathnames are relative to the location where the JavaServer is installed on your machine. For example, the URL Pathname for the cgi-bin servlet is /cgi-bin. However, the relative pathname is server_root/cgi-bin. If your server_root is actually /home/~erik/JavaServerFCS, your actual servlet URL pathname is /home/~erik/JavaServerFCS/cgi-bin.

Servlet Invoked
The name of the servlet being invoked. For example, once you have setup a servlet alias, you can connect to the servlet by entering the alias into a server-side include or URL.

Note: Besides aliasing a specific servlet, you can also alias a servlet chain. A servlet chain is two or more servlets linked together so that each servlet in the chain is called in succession by the previous servlet. All of the servlets in a servlet chain can be aliased to one alias name. When a request arrives for that alias, all the servlets in the chain will be invoked.

To specify a servlet chain in the Servlet Invoked field, enter the name of each servlet, separated by commas but no spaces. (For example, finger,snoop,date).

Procedures

To Add a Servlet Alias:

  1. Click Add to open a new line.
  2. Enter the URL Pathname you want to use to invoke the servlet.
  3. Enter the name of the servlet.
  4. Click Save.

To Delete a Servlet Alias:

  1. Select the alias from the list.
  2. Click Remove.
  3. Click Save.

To Edit a Servlet Alias:

  1. Select an alias from the list.
  2. Click Modify.
  3. Remove the existing text and enter new text, or append text to the existing information.
  4. Click Save.
Note: To move to a new field, click on that field.

Buttons

To make changes to the Servlet Alias page and have those settings take affect, use the five buttons at the bottom of the screen. These are: Note: If you Add, Modify, or Remove an alias pathname, you must Save before the changes take affect.
Top
java-server-feedback@java.sun.com